home *** CD-ROM | disk | FTP | other *** search
/ Speccy ClassiX 1998 / Speccy ClassiX 98.iso / amiga_system / the_aminet / comm / news / npns.lha / NPNS / NewPostNewsSpool.doc next >
Text File  |  1995-09-30  |  4KB  |  139 lines
  1.                New Post News Spool v3.3
  2.  
  3.                    by
  4.  
  5.                   Nick d'Alterio
  6.  
  7.                    September 1995
  8.  
  9.  
  10. Introduction
  11. -------------
  12.  
  13. A while back I was looking for a way of spooling news so that I could 
  14. write articles offline and then send them when I went online. I found
  15. the a set of programs to do this in PostNewsSpool by James Burton.
  16.  
  17. However I found that there were a number of problems with postnews
  18. and sendnews such as:-
  19.  
  20. The check to see if online took far too long
  21. Locks were often left on the spool dir 
  22. Lots of unnecessary files were produced
  23. If news posting fails for some reason the message was lost
  24.  
  25. These versions have eliminated these problems and added a couple 
  26. of extra features.
  27.  
  28. Installation
  29. ------------
  30.  
  31. Copy sendnews and postnews to AmiTCP:bin/ and set the appropriate
  32. environment variable described below.
  33.  
  34. postnews should be the program that is called by your news reading
  35. program to post the news. This will spool the article so that you 
  36. can use sendnews to send it off when you go online.
  37.  
  38. Although it is possible to use to spool news without the rest of the
  39. package I recommend that you get the complete postnewsspool archive
  40. by James Burton.
  41.  
  42. NOTE This is an AmiTCP only program since I don't know how to check
  43. for 'online-ness' for AS225r2.
  44.  
  45. Updating
  46. --------
  47.  
  48. Note that from version 3 sendnews will attempt to send any article
  49. in the spooldir no matter what the name is. So if your news reader
  50. produces a fully formed news article with header you can drop it
  51. straight into the spooldir without using postnews.
  52.  
  53. You should remove the seq file if you had it in your spooldir and 
  54. the env variable PNS_SEQFILE
  55.  
  56. Sendnews
  57. --------
  58.  
  59. Simply run the program and it will send off all messages in the
  60. spool directory indicated by the environment variable PNS_SPOOLDIR
  61. (AmiTCP:Usr/Spool/News by default).
  62.  
  63. The news articles will be posted using the program specified in
  64. PNS_NNTPPOST (AmiTCP:bin/NNTPPost by default ). If the posting program
  65. fails to post the article the article will then be appended to the
  66. end of the failed archive indicated by PNS_FAILED_ARC 
  67. ( AmiTCP:Usr/Spool/sendnews.failed by default ). Each file in the
  68. failed archive will be separated by a line containing the date and time
  69. sendnews failed to post the article. 
  70.  
  71. Remember that NNTPPost requires that the environment variable NNTPSERVER
  72. is set.
  73.  
  74. Postnews
  75. --------
  76.  
  77. This spools articles which have already had the header prepared by
  78. another program such as tin. It places the article in the spool 
  79. directory PNS_SPOOLDIR (AmiTCP:Usr/Spool/News by default). The
  80. spooled filename has the format msg.######### where ###### is a 
  81. number which refers to the time of writing.
  82.  
  83. If online at the time of writing the article then postnews immediately
  84. executes sendnews (which must be in AmiTCP:bin/) to send off the article.
  85. To stop postnews from sending the article create an enviroment variable
  86. called PNS_OFFLINE.
  87.  
  88. Command line options:-
  89.  
  90.     -from "someone@somewhere"      Add a from line to the header of
  91.                        article.
  92.  
  93.     -n                   Don't call sendnews if online
  94.  
  95.     -h                             Prints some help
  96.  
  97.  
  98. Usage:-
  99.  
  100.     postnews article
  101.     postnews < article
  102.  
  103. e.g. For tin I use
  104.  
  105. set TIN_POST amitcp:bin/postnews -from "daltern@ic.ac.uk (Nicholas d'Alterio)" %s
  106.  
  107. History
  108. -------
  109.  
  110. 3.2   - New enviroment variable PNS_OFFLINE
  111. 3.1   - Now uses ADOS functions
  112.       - seq file no longer needed
  113.       - ANY file in the spooldir will be sent
  114.       - the failed archive entries are separated by a line
  115.     containing the time the file failed.
  116.       - new env variable PNS_NNTPPOST allows user to specify
  117.     program to post news
  118.  
  119. 2.1   - Added support for environment variables
  120. 1.x   - Internal test versions
  121.  
  122. Conditions of Use
  123. -----------------
  124.  
  125. Use it how you like just remember I accept NO liability for
  126. ANYTHING that happens.
  127.  
  128. Let me know of what you think of it, bugs, etc
  129.  
  130. Thanks
  131. ------
  132.  
  133. Thanks to James Burton for the original idea and code.
  134.  
  135. ------------------------------------------------------------------------------------
  136. Nick d'Alterio (n.dalterio@ic.ac.uk)
  137.  
  138. $Id: NewPostNewsSpool.doc 1.5 1995/09/30 21:29:44 daltern Exp $
  139.